home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / IMP_TRUE.1 < prev    next >
Encoding:
Text File  |  1996-06-13  |  5.8 KB  |  134 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Import-trueSpace
  3. .SH NAME
  4. imp_truespace \- Caligari trueSpace geometry import filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the trueSpace geometry
  8. import converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert a trueSpace file to Wavefront using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i wave -o wave filename.cob
  16. .PP
  17. To convert a trueSpace file to VRML and override some of the default options 
  18. in setup.ini:
  19. .IP
  20. pt -i true -in-true-debug = yes -o vrml filename.true
  21. .PP
  22. .SH OVERVIEW
  23. .PP
  24. This is a highly accurate geometry import converter that reads in Caligari 
  25. trueSpace '.cob' and '.scn' binary scene files. This is a 'load and render'
  26. converter that imports and translates all aspects of the scene file so that 
  27. little or no modifications must be done in the target rendering program to 
  28. produce equivalent results to that created by the trueSpace renderer. 
  29. .PP
  30. The following are some of the features of this converter:
  31. .IP
  32. All geometry is read in including the local axes and all material assignments. 
  33. .IP
  34. Holes within polygons are also properly converted into NuGraf compatible 
  35. meshed polygons with holes.
  36. .IP
  37. All (u,v) texture coordinates are read in and stored along with the meshed 
  38. polygon data.
  39. .IP
  40. All three polygon faceting modes are properly handled: faceted, autofacet and 
  41. 'smooth'. This allows proper smoothing of the data as per the Caligari 
  42. trueSpace smoothing conventions.
  43. .IP
  44. The original scene hierarchy is completely recreated, including all groupings 
  45. and their related transformations.
  46. .PP
  47. In addition, this converter reads in *every* material attribute and 
  48. accurately translates the shading parameters to equivalent NuGraf shading 
  49. parameters. The NuGraf renderer will be able to render any trueSpace file 
  50. with little or no modification with results that are almost exactly the same 
  51. as within trueSpace. The following describes some of the shading parameter 
  52. translations:
  53. .IP
  54. Flat, smooth and metal shading modes are translated properly.
  55. .IP
  56. The 'metal' shading mode properly takes into account the edge transparency 
  57. dropoff.
  58. .IP
  59. The 'shininess' parameter is properly decoded into three NuGraf shading 
  60. parameters of diffuse, specular and ray-traced shininess. This decoding is 
  61. quite important to properly recreate trueSpace scenes.
  62. .IP
  63. Cubic and spherical environment map are translated into equivalent NuGraf 
  64. environment map types.
  65. .IP
  66. Texture maps are properly translated, as well as the image filename, the u/v 
  67. scaling factors and the u/v offset values.
  68. .IP
  69. Likewise, the bump map textures and all of its related parameters are 
  70. properly translated.
  71. .PP
  72. .SH CONVERTER LIMITATIONS
  73. .PP
  74. trueSpace binary scene files do not include U/V tangent vectors which are 
  75. typically required by other rendering programs in order to perform bump 
  76. mapping. Thus, even though the bump mapping parameters are properly translated, 
  77. no bump mapping will appear in the target rendering program because of this 
  78. lack of U/V tangent vectors. To circumvent this problem you will have to 
  79. apply the U/V tangent vectors in the target rendering program (typically by 
  80. assigning a 'texture projection' to the object(s) in question).
  81.  
  82. At this time the only aspect of the file that has not been translated into 
  83. equivalent NuGraf renderer parameters are the three trueSpace procedural 
  84. texture mapping functions: granite, marble and wood. These are highly 
  85. specific to the trueSpace renderer.
  86.  
  87. All texture filenames are stripped of their pathnames and unrecognized image 
  88. file types are translated to TIFF file types. For example, if the trueSpace 
  89. image filename is 'c:\truespace\image.txr' then it will be translated to 
  90. 'image.tif'.
  91.  
  92. This converter does not read in the ASCII version of Caligari trueSpace files since they are 
  93. not at all common.
  94.  
  95. .PP
  96. .SH COMMAND LINE OPTIONS
  97. .PP
  98. The following options are specific to this import converter:
  99. .TP
  100. -i true
  101. This is the optional command line option which specifies that the input data
  102. is in the trueSpace file format. If not specified then the 
  103. converter will try to guess the input file's format from its file extension
  104. and then from the contents of its file. Note that the valid file extensions
  105. are .cob and .scn.  ASCII trueSpace files are not accommodated.
  106. .TP
  107. -in-true-remove-dbl-sided-polygons = [ yes | no ]
  108. When trueSpace adds a single flat polygon to a scene it actually adds two 
  109. duplicated polygons that are exactly the same except that the two polygons 
  110. face in opposite directions. These doubled sided polygons cause problems with 
  111. many rendering programs so this option, when enabled, allows double sided 
  112. polygons to be deleted from the scene. It is enabled ('on') by default.
  113. .TP
  114. -in-true-smooth = [ yes | no ]
  115. If 'yes', which is the default, then smoothed vertex normals will be
  116. computed based on the smoothing information contained within the trueSpace
  117. file; this will make the resulting object(s) appear to be smooth.
  118. If set to 'no' then no smoothing will be performed, and hence the
  119. resulting object(s) will appear to be flat shaded since they have no
  120. vertex normals associated with them.
  121. .TP
  122. -in-true-print-stats = [ yes | no ]
  123. If 'yes', which is the default, then statistics will be displayed about the 
  124. parsed input file.
  125. .TP
  126. -in-true-print-warn = [ yes | no ]
  127. If 'yes' then any warnings output from the parser will be displayed. The
  128. default is 'no'.
  129. .TP
  130. -in-true-debug = [ yes | no ]
  131. If 'yes' then verbose parsing information will be output to the file ASCII
  132. 'debugcob.txt' located within the current working directory. The default 
  133. is 'no'.
  134.